ZR RAW Extended
===============
Version: 1.2.3
Build: 253
Build date: 2026-10-07
Channel: Official Release

Getting started
---------------
1. Open Install ZR RAW Extended.app. This community app is not Apple notarized;
   macOS may require Control-click > Open or approval in Privacy & Security.
2. Setup places the app in Applications and checks its requirements. Missing
   components need internet access and may require a Mac administrator.
   Setup automatically checks dependency-manager compatibility when needed and
   attempts recovery on recently updated Macs. It does not upgrade unrelated apps.
3. If Terminal requests your Mac password, typing shows no characters or dots.
   Type it normally and press Return. Never send your password to support.
4. Open the app, add camera files, choose a destination and output, then export.

Requirements
------------
Intel or Apple silicon, macOS 13 or later, and enough free space for your media.
Setup checks Python, FFmpeg and REDCINE-X PRO and installs missing components.
DaVinci Resolve Studio is optional for REDline exports. To use Resolve, install
it separately, set External scripting using to Local, and restart Resolve.
The current qualification Mac uses Resolve Studio 21.1. Resolve 21.1 requires
macOS 15 or later; the REDline workflow retains the app's macOS 13 minimum.
You do not need an Apple Developer account.

Workflows
---------
Auto Export creates verified H.265 10-bit 4:2:2, optional 4:2:0, or ProRes files.
Standard 4:2:2 remains the default. Sony-inspired 4:2:0 offers Compact, Balanced
and Detail tiers; Nikon-inspired 4:2:0 uses higher bitrates and larger files.
Camera-inspired targets scale to each clip's resolution and frame rate. These
names describe bitrate references, not camera color profiles or encoders.
Review the per-clip bitrate and size estimate before exporting.
Timeline Builder uses Resolve for manual RAW adjustments before rendering.
New projects stay in the ZR RAW Extended Timelines folder at the root of the
active Resolve project library, including projects prepared by the listener.
Render Timeline Clips bakes Camera RAW adjustments and excludes preview colors
and Color-page grades without changing their states. Original camera audio is
preserved; timeline audio edits are not included. Mixed resolutions and frame rates
are organized into native-format timelines. Use a new destination for another
render, and separate sessions for sources that share a filename.
ProRes RAW Timeline rendering requires Resolve 21.1 or later. It preserves RAW
adjustments in the verified camera-log profile, then restores the viewing preview.
Nikon N-Log and Panasonic V-Log profiles are recognized; unknown profiles stop
instead of guessing. Build separate Timeline Builder sessions per profile. R3D and
N-RAW keep their existing camera-log workflows.

The optional listener watches chosen folders and offers a five-second review
before starting. Configure the engine, output and destination in Listener
settings. Previously processed files are recognized in the queue.
For REDline H.265, select a fast cache drive when prompted. The app checks space
and manages its temporary media. Persistent Timeline Builder projects remain
available for later editing.

App updates
-----------
This installer enables future in-app updates. Open ZR RAW Extended > Check for
Updates to view release notes, download an official update, and install/relaunch.
Update checks also run periodically while the app is open. Updates require your
approval and are postponed while work is active. Your queue and settings are
preserved. macOS may request administrator approval to replace a protected app.
The first installation and dependency repairs still use the installer.

Optional source cleanup
-----------------------
Move originals to Trash after export is OFF by default. Manual Auto Export and
the listener have separate settings and confirmation warnings. Keep a separate
RAW backup and review your compression settings before enabling either option.
Only newly exported clips in a completely successful queue are eligible after
additional full-file verification. This adds time. Uncertain, changed, skipped
and segmented sources stay in place. Timeline Builder always keeps sources.
Files go to macOS Trash, never permanent deletion. Empty Trash manually to free
storage. If macOS cannot use Trash, the app does not permanently delete files.

Help
----
Repair Installation checks missing requirements. A non-admin user may need
their Mac administrator to complete dependency installation.
If setup fails, you can save a diagnostic report or consent to send it securely.
Reports never require your footage or Mac password. Keep the case code for
support. No report is sent without your consent.

created by Irving de Jong | @thebrightesthour
